QuickTime 4 Reference

Lens Flare

kLensFlareImageFilterType ('lens')

The lens flare effect simulates the effect of light reflecting from a camera lens. You can select the shape of the flare from a list, set the size and brightness of the flare effect, and set x and y values that will cause the flare to move accross the lens during the effect. You can also set several parameters that affect specific aspects of the flare, such as the number of sides for a polygon flare or the flare color.

Example:

The lens flare effect requires QuickTime 4.0 or later.

The lens flare effect takes one source and has fifteen parameters.

Parameters

Use the descriptions below to help you understand what the parameters do. To learn how to use parameter atoms, see "Adding Video Effects to a QuickTime Movie" s

Name	Code	QTAtom Type	Description
Size	`size'	`kParameterTypeDataFixed` Can be a tween	Size of the effect Range 1-20. Default 1.
Brightness	`'gbri'`	`kParameterTypeDataFixed` Can be a tween	Brightness of the effect Range 0-1. Default 1.
X	`'xcnt'`	`kParameterTypeDataFixed` Always a tween	X-coordinate of the effect center Range -2 to 2. Default 0.
Y	'`ycnt` '	`kParameterTypeDataFixed` Always a tween	Y-coordinate of the effect center Range -2 to 2. Default 0.
Type	`'ftyp'`	`kParameterEnumList`	Type of flare See enumeration list below.
Color	``flrc` '	`kParameterTypeDataRGBValue`	Flare color Black or white. Default white.
Brightness	`fbri'	`kParameterTypeDataFixed`	Flare brightness Range 0-2. Default 1.
Size	`fsiz'	`kParameterTypeDataFixed`	Flare size Range 0-1. Default 0.5.
Position	`fylc'	`kParameterTypeDataFixed`	Position of flare element along centerline Range -2 to 2. Default 0.
Offset	`fxlc'	`kParameterTypeDataFixed`	Offset of flare element's center (creates a hole if nonzero) Range -2 to 2. Default 0.
Solid	`fsz1'	`kParameterTypeDataFixed`	Portion of flare that doesn't fade Range -2 to 2. Default 0.
Anamorphic	`fana'	`kParameterTypeDataBitField`	Flare is round if `false` , oval if `true.` Default `false` .
Number	`fnum'	`kParameterTypeDataLong`	The number of spikes (for a starburst) or sides (for a polygon) Range 1-20. Default 1.
Count	`fcnt'	`kParameterTypeDataLong`	The number of flare elements. If Count = N > 1, there are a random number of flare elements (1 to N). Range 1-50. Default 1.
Seed	`fsed'	`kParameterTypeDataLong`	Seed for the random number generator if Count > 1. Range 0-1000. Default 500.

Flare Type Enumeration List

Value	String	Description
1	Spot	A linear spot
2	Round Spot	A squared-distance spot
3	Reverse Spot	A linear spot, center dark rather than light
4	Reverse Round Spot	A squared-distance spot, center dark rather than light
5	Star Burst	A spikey ball with `Number' spikes
6	Polygon	A polygon with `Number' sides